<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Module::Find - Find and use installed modules in a (sub)category - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of Module-Find - MetaCPAN" href="https://metacpan.org/dist/Module-Find/releases.rss" />
        <link rel="canonical" href="./Module::Find.html" />
        <meta name="description" content="Find and use installed modules in a (sub)category" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/Module::Find" />
<meta name="twitter:title"       content="Module::Find" />
<meta name="twitter:description" content="Find and use installed modules in a (sub)category" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./Module::Find.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of Module-Find was released.">
      <span class="relatize">01 Aug 2022 15:10:09 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/Module-Find">Module-Find</a>
  </li>
  <li>
    Module version: 0.16
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/Module-Find/source/Find.pm">Source</a>
    (<a href="https://metacpan.org/dist/Module-Find/source/Find.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/Module-Find/source">Browse</a>
    (<a href="https://metacpan.org/dist/Module-Find/source?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/Module-Find/changes">Changes</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/Module-Find/contribute">How to Contribute</a>
    </li>
    <li>
        <a rel="noopener nofollow" data-keyboard-shortcut="g r" href="https://github.com/crenz/Module-Find">Repository</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://rt.cpan.org/Public/Dist/Display.html?Name=Module-Find">Issues</a>
      (1)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=Module-Find+0.16" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/M/Module-Find.html?oncpan=1&amp;distmat=1&amp;version=0.16&amp;grade=2" style="color: #090">4026</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/M/Module-Find.html?oncpan=1&amp;distmat=1&amp;version=0.16&amp;grade=3" style="color: #900">0</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/M/Module-Find.html?oncpan=1&amp;distmat=1&amp;version=0.16&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/CRENZ/Module-Find-0.16">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on Module-Find who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 1
      </div>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpancover.com/latest/Module-Find-0.16/index.html">95.28% Coverage </a>
    </li>
    <li>
      License: perl_5
    </li>
    <li>
      Perl: v5.8.1
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/Module-Find/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/C/CR/CRENZ/Module-Find-0.16.tar.gz">
      Download (<span itemprop="fileSize">9.34KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FCRENZ%2FModule-Find-0.16%2FFind.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Module-Find/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Module-Find/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:Module-Find">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="Module-Find">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/Find.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="CRENZ/Module-Find-0.16"
>0.16
  (CRENZ on 2022-08-01)</option>
<option
  
  value="CRENZ/Module-Find-0.15"
>0.15
  (CRENZ on 2019-12-26)</option>
<option
  
  value="CRENZ/Module-Find-0.14"
>0.14
  (CRENZ on 2019-12-25)</option>
<option
  
  value="CRENZ/Module-Find-0.13"
>0.13
  (CRENZ on 2015-03-09)</option>
<option
  
  value="CRENZ/Module-Find-0.12"
>0.12
  (CRENZ on 2014-02-06)</option>
<option
  
  value="CRENZ/Module-Find-0.11"
>0.11
  (CRENZ on 2012-05-22)</option>
<option
  
  value="CRENZ/Module-Find-0.10"
>0.10
  (CRENZ on 2010-02-26)</option>
<option
  
  value="CRENZ/Module-Find-0.09"
>0.09
  (CRENZ on 2010-02-26)</option>
<option
  
  value="CRENZ/Module-Find-0.08"
>0.08
  (CRENZ on 2009-09-08)</option>
<option
  
  value="CRENZ/Module-Find-0.06"
>0.06
  (CRENZ on 2008-01-26)</option>
<option
  
  value="CRENZ/Module-Find-0.05"
>0.05
  (CRENZ on 2005-11-30)</option>
<option
  
  value="CRENZ/Module-Find-0.04"
>0.04
  (CRENZ on 2005-05-19)</option>
<option
  
  value="CRENZ/Module-Find-0.03"
>0.03
  (CRENZ on 2004-06-17)</option>
<optgroup label="BackPAN">'
<option
  
  value="CRENZ/Module-Find-0.07"
>0.07
  (CRENZ on 2009-09-07)</option>
<option
  
  value="BDFOY/Module-Find-0.1_1"
>0.1_1 DEV
  (BDFOY on 2004-06-17)</option>
<option
  
  value="CRENZ/Module-Find-0.02"
>0.02
  (CRENZ on 2004-05-24)</option>
<option
  
  value="CRENZ/Module-Find-0.01"
>0.01
  (CRENZ on 2004-04-22)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/CRENZ/Module-Find-0.16/diff/' + encodeURIComponent(this.value) + '/Find.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="CRENZ/Module-Find-0.16"
>0.16
  (CRENZ on 2022-08-01)</option>
<option
  
  value="CRENZ/Module-Find-0.15"
>0.15
  (CRENZ on 2019-12-26)</option>
<option
  
  value="CRENZ/Module-Find-0.14"
>0.14
  (CRENZ on 2019-12-25)</option>
<option
  
  value="CRENZ/Module-Find-0.13"
>0.13
  (CRENZ on 2015-03-09)</option>
<option
  
  value="CRENZ/Module-Find-0.12"
>0.12
  (CRENZ on 2014-02-06)</option>
<option
  
  value="CRENZ/Module-Find-0.11"
>0.11
  (CRENZ on 2012-05-22)</option>
<option
  
  value="CRENZ/Module-Find-0.10"
>0.10
  (CRENZ on 2010-02-26)</option>
<option
  
  value="CRENZ/Module-Find-0.09"
>0.09
  (CRENZ on 2010-02-26)</option>
<option
  
  value="CRENZ/Module-Find-0.08"
>0.08
  (CRENZ on 2009-09-08)</option>
<option
  
  value="CRENZ/Module-Find-0.06"
>0.06
  (CRENZ on 2008-01-26)</option>
<option
  
  value="CRENZ/Module-Find-0.05"
>0.05
  (CRENZ on 2005-11-30)</option>
<option
  
  value="CRENZ/Module-Find-0.04"
>0.04
  (CRENZ on 2005-05-19)</option>
<option
  
  value="CRENZ/Module-Find-0.03"
>0.03
  (CRENZ on 2004-06-17)</option>
<optgroup label="BackPAN">'
<option
  
  value="CRENZ/Module-Find-0.07"
>0.07
  (CRENZ on 2009-09-07)</option>
<option
  
  value="BDFOY/Module-Find-0.1_1"
>0.1_1 DEV
  (BDFOY on 2004-06-17)</option>
<option
  
  value="CRENZ/Module-Find-0.02"
>0.02
  (CRENZ on 2004-05-24)</option>
<option
  
  value="CRENZ/Module-Find-0.01"
>0.01
  (CRENZ on 2004-04-22)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><a href="https://metacpan.org/pod/File::Find" title="File::Find" class="ellipsis">File::Find</a></li>
  <li><a href="https://metacpan.org/pod/File::Spec" title="File::Spec" class="ellipsis">File::Spec</a></li>
  <li><i class="ttip" title="dynamic_config enabled">and possibly others</i></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/Module::Find/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=Module%3A%3AFind">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=Module-Find">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/CRENZ/Module-Find-0.16/view/Find.pm">This version</a>
    </li>
    <li>
      <a href="./Module::Find.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
<a class="display-all" href="https://metacpan.org/author/TSIBLEY"><img src="https://www.gravatar.com/avatar/a09cbdbd4c85618a83795f01f7d217af?d=identicon&amp;s=20" title="TSIBLEY" alt="TSIBLEY"></a>
<a class="display-all" href="https://metacpan.org/author/KEEDI"><img src="https://www.gravatar.com/avatar/95f905a7a4ccc573c711e9d264c0fde8?d=identicon&amp;s=20" title="KEEDI" alt="KEEDI"></a>
<a class="display-all" href="https://metacpan.org/author/KES"><img src="https://www.gravatar.com/avatar/e8530f00b43b4f6a056f8ad4ee52ea47?d=identicon&amp;s=20" title="KES" alt="KES"></a>
<a class="display-all" href="https://metacpan.org/author/PLU"><img src="https://www.gravatar.com/avatar/b4db07dda59c4fcacce75e943ff4cbb7?d=identicon&amp;s=20" title="PLU" alt="PLU"></a>
<a class="display-all" href="https://metacpan.org/author/MIXAS"><img src="https://www.gravatar.com/avatar/57024569984e31ce52a855c7305be66e?d=identicon&amp;s=20" title="MIXAS" alt="MIXAS"></a>
</div>
<!-- Display counts of plussers-->
<div>
    <a href="https://metacpan.org/dist/Module-Find/plussers">6 PAUSE users</a>
</div>
<div>
    3 non-PAUSE users
</div>
</div>
    </li>
    <li>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/CRENZ" class="author-name">Christian Renz</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/Find.pm&#39;" class="">
<option
  selected
  value="CRENZ/Module-Find-0.16"
>0.16
  (CRENZ on 2022-08-01)</option>
<option
  
  value="CRENZ/Module-Find-0.15"
>0.15
  (CRENZ on 2019-12-26)</option>
<option
  
  value="CRENZ/Module-Find-0.14"
>0.14
  (CRENZ on 2019-12-25)</option>
<option
  
  value="CRENZ/Module-Find-0.13"
>0.13
  (CRENZ on 2015-03-09)</option>
<option
  
  value="CRENZ/Module-Find-0.12"
>0.12
  (CRENZ on 2014-02-06)</option>
<option
  
  value="CRENZ/Module-Find-0.11"
>0.11
  (CRENZ on 2012-05-22)</option>
<option
  
  value="CRENZ/Module-Find-0.10"
>0.10
  (CRENZ on 2010-02-26)</option>
<option
  
  value="CRENZ/Module-Find-0.09"
>0.09
  (CRENZ on 2010-02-26)</option>
<option
  
  value="CRENZ/Module-Find-0.08"
>0.08
  (CRENZ on 2009-09-08)</option>
<option
  
  value="CRENZ/Module-Find-0.06"
>0.06
  (CRENZ on 2008-01-26)</option>
<option
  
  value="CRENZ/Module-Find-0.05"
>0.05
  (CRENZ on 2005-11-30)</option>
<option
  
  value="CRENZ/Module-Find-0.04"
>0.04
  (CRENZ on 2005-05-19)</option>
<option
  
  value="CRENZ/Module-Find-0.03"
>0.03
  (CRENZ on 2004-06-17)</option>
<optgroup label="BackPAN">'
<option
  
  value="CRENZ/Module-Find-0.07"
>0.07
  (CRENZ on 2009-09-07)</option>
<option
  
  value="BDFOY/Module-Find-0.1_1"
>0.1_1 DEV
  (BDFOY on 2004-06-17)</option>
<option
  
  value="CRENZ/Module-Find-0.02"
>0.02
  (CRENZ on 2004-05-24)</option>
<option
  
  value="CRENZ/Module-Find-0.01"
>0.01
  (CRENZ on 2004-04-22)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/Module-Find">Module-Find-0.16</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage three &#10;
          • 79 direct dependents &#10;          • 463 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="10"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="Module-Find-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="Module-Find-0.16">
    <input type="hidden" name="author" value="CRENZ">
    <input type="hidden" name="distribution" value="Module-Find">
    <button type="submit" class="favorite highlight"><span>9</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./Module::Find.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>9</span> ++</a>
</div>
   / <span>Module::Find</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./Module::Find.html#NAME">NAME</a></li>
  <li><a href="./Module::Find.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./Module::Find.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./Module::Find.html#FUNCTIONS">FUNCTIONS</a></li>
  <li><a href="./Module::Find.html#HISTORY">HISTORY</a></li>
  <li><a href="./Module::Find.html#DEVELOPMENT-NOTES">DEVELOPMENT NOTES</a></li>
  <li><a href="./Module::Find.html#SEE-ALSO">SEE ALSO</a></li>
  <li><a href="./Module::Find.html#AUTHOR">AUTHOR</a></li>
  <li><a href="./Module::Find.html#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>Module::Find - Find and use installed modules in a (sub)category</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code>  use Module::Find;

  # use all modules in the Plugins/ directory
  @found = usesub Mysoft::Plugins;

  # use modules in all subdirectories
  @found = useall Mysoft::Plugins;

  # find all DBI::... modules
  @found = findsubmod DBI;

  # find anything in the CGI/ directory
  @found = findallmod CGI;
  
  # set your own search dirs (uses @INC otherwise)
  setmoduledirs(@INC, @plugindirs, $appdir);
  
  # not exported by default
  use Module::Find qw(ignoresymlinks followsymlinks);
  
  # ignore symlinks
  ignoresymlinks();
  
  # follow symlinks (default)
  followsymlinks();</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>Module::Find lets you find and use modules in categories. This can be very useful for auto-detecting driver or plugin modules. You can differentiate between looking in the category itself or in all subcategories.</p>

<p>If you want Module::Find to search in a certain directory on your harddisk (such as the plugins directory of your software installation), make sure you modify <code>@INC</code> before you call the Module::Find functions.</p>

<h1 id="FUNCTIONS">FUNCTIONS</h1>

<dl>

<dt id="setmoduledirs(@directories)"><a id="setmoduledirs"></a><a id="setmoduledirs-directories"></a><code>setmoduledirs(@directories)</code></dt>
<dd>

<p>Sets the directories to be searched for modules. If not set, Module::Find will use @INC. If you use this function, @INC will <i>not</i> be included automatically, so add it if you want it. Set to undef to revert to default behaviour.</p>

</dd>
<dt id="@found-=-findsubmod-Module::Category"><a id="found---findsubmod-Module::Category"></a><code>@found = findsubmod Module::Category</code></dt>
<dd>

<p>Returns modules found in the Module/Category subdirectories of your perl installation. E.g. <code>findsubmod CGI</code> will return <code>CGI::Session</code>, but not <code>CGI::Session::File</code> .</p>

</dd>
<dt id="@found-=-findallmod-Module::Category"><a id="found---findallmod-Module::Category"></a><code>@found = findallmod Module::Category</code></dt>
<dd>

<p>Returns modules found in the Module/Category subdirectories of your perl installation. E.g. <code>findallmod CGI</code> will return <code>CGI::Session</code> and also <code>CGI::Session::File</code> .</p>

</dd>
<dt id="@found-=-usesub-Module::Category"><a id="found---usesub-Module::Category"></a><code>@found = usesub Module::Category</code></dt>
<dd>

<p>Uses and returns modules found in the Module/Category subdirectories of your perl installation. E.g. <code>usesub CGI</code> will return <code>CGI::Session</code>, but not <code>CGI::Session::File</code> .</p>

<p>If any module dies during loading, usesub will also die at this point.</p>

</dd>
<dt id="@found-=-useall-Module::Category"><a id="found---useall-Module::Category"></a><code>@found = useall Module::Category</code></dt>
<dd>

<p>Uses and returns modules found in the Module/Category subdirectories of your perl installation. E.g. <code>useall CGI</code> will return <code>CGI::Session</code> and also <code>CGI::Session::File</code> .</p>

<p>If any module dies during loading, useall will also die at this point.</p>

</dd>
<dt id="ignoresymlinks()"><a id="ignoresymlinks"></a><code>ignoresymlinks()</code></dt>
<dd>

<p>Do not follow symlinks. This function is not exported by default.</p>

</dd>
<dt id="followsymlinks()"><a id="followsymlinks"></a><code>followsymlinks()</code></dt>
<dd>

<p>Follow symlinks (default behaviour). This function is not exported by default.</p>

</dd>
</dl>

<h1 id="HISTORY">HISTORY</h1>

<dl>

<dt id="0.01,-2004-04-22"><a id="0"></a><a id="pod"></a>0.01, 2004-04-22</dt>
<dd>

<p>Original version; created by h2xs 1.22</p>

</dd>
<dt id="0.02,-2004-05-25"><a id="01"></a><a id="pod1"></a>0.02, 2004-05-25</dt>
<dd>

<p>Added test modules that were left out in the first version. Thanks to Stuart Johnston for alerting me to this.</p>

</dd>
<dt id="0.03,-2004-06-18"><a id="02"></a><a id="pod2"></a>0.03, 2004-06-18</dt>
<dd>

<p>Fixed a bug (non-localized $_) by declaring a loop variable in use functions. Thanks to Stuart Johnston for alerting me to this and providing a fix.</p>

<p>Fixed non-platform compatibility by using File::Spec. Thanks to brian d foy.</p>

<p>Added setmoduledirs and updated tests. Idea shamelessly stolen from ...errm... inspired by brian d foy.</p>

</dd>
<dt id="0.04,-2005-05-20"><a id="03"></a><a id="pod3"></a>0.04, 2005-05-20</dt>
<dd>

<p>Added POD tests.</p>

</dd>
<dt id="0.05,-2005-11-30"><a id="04"></a><a id="pod4"></a>0.05, 2005-11-30</dt>
<dd>

<p>Fixed issue with bugfix in PathTools-3.14.</p>

</dd>
<dt id="0.06,-2008-01-26"><a id="05"></a><a id="pod5"></a>0.06, 2008-01-26</dt>
<dd>

<p>Module::Find now won&#39;t report duplicate modules several times anymore (thanks to Uwe V&ouml;lker for the report and the patch)</p>

</dd>
<dt id="0.07,-2009-09-08"><a id="06"></a><a id="pod6"></a>0.07, 2009-09-08</dt>
<dd>

<p>Fixed RT#38302: Module::Find now follows symlinks by default (can be disabled).</p>

</dd>
<dt id="0.08,-2009-09-08"><a id="07"></a><a id="pod7"></a>0.08, 2009-09-08</dt>
<dd>

<p>Fixed RT#49511: Removed Mac OS X extended attributes from distribution</p>

</dd>
<dt id="0.09,-2010-02-26"><a id="08"></a><a id="pod8"></a>0.09, 2010-02-26</dt>
<dd>

<p>Fixed RT#38302: Fixed META.yml generation (thanks very much to cpanservice for the help).</p>

</dd>
<dt id="0.10,-2010-02-26"><a id="09"></a><a id="pod9"></a>0.10, 2010-02-26</dt>
<dd>

<p>Fixed RT#55010: Removed Unicode BOM from Find.pm.</p>

</dd>
<dt id="0.11,-2012-05-22"><a id="010"></a><a id="pod10"></a>0.11, 2012-05-22</dt>
<dd>

<p>Fixed RT#74251: defined(@array) is deprecated under Perl 5.15.7. Thanks to Roman F, who contributed the implementation.</p>

</dd>
<dt id="0.12,-2014-02-08"><a id="011"></a><a id="pod11"></a>0.12, 2014-02-08</dt>
<dd>

<p>Fixed RT#81077: useall fails in taint mode Thanks to Aran Deltac, who contributed the implementation and test.</p>

<p>Fixed RT#83596: Documentation doesn&#39;t describe behaviour if a module fails to load Clarified documentation for useall and usesub.</p>

<p>Fixed RT#62923: setmoduledirs(undef) doesn&#39;t reset to searching @INC Added more explicit tests. Thanks to Colin Robertson for his input.</p>

</dd>
<dt id="0.13,-2015-03-09"><a id="012"></a><a id="pod12"></a>0.13, 2015-03-09</dt>
<dd>

<p>This release contains two contributions from Moritz Lenz:</p>

<p>Link to Module::Pluggable and Class::Factory::Util in &quot;SEE ALSO&quot;</p>

<p>Align package name parsing with how perl does it (allowing single quotes as module separator)</p>

<p>Also, added a test for meta.yml</p>

</dd>
<dt id="0.14,-2019-12-25"><a id="013"></a><a id="pod13"></a>0.14, 2019-12-25</dt>
<dd>

<p>A long overdue update. Thank you for the many contributions!</p>

<p>Fixed RT#99055: Removed file readability check (pull request contributed by Moritz Lenz)</p>

<p>Now supports @INC hooks (pull request contributed by Graham Knop)</p>

<p>Now filters out filenames starting with a dot (pull request contributed by Desmond Daignault)</p>

<p>Now uses strict (pull request contributed by Shlomi Fish)</p>

<p>Fixed RT#122016: test/ files show up in metacpan (bug report contributed by Karen Etheridge)</p>

</dd>
<dt id="0.15,-2019-12-26"><a id="014"></a><a id="pod14"></a>0.15, 2019-12-26</dt>
<dd>

<p>Fixed RT#127657 (bug report contributed by Karen Etheridge): Module::Find now uses @ModuleDirs (if specified) for loading modules. Previously, when using setmoduledirs() to set an array of directories that did not contain @INC, Module::Find would find the modules correctly, but load them from @INC.</p>

</dd>
<dt id="0.16,-2022-08-01"><a id="015"></a><a id="pod15"></a>0.16, 2022-08-01</dt>
<dd>

<p>Fixes an issue where symlink tests failed on systems that do not support creation of symlinks. The issue appears on Windows systems due to changed behaviour in <code>File::Find</code> described in <a href="https://github.com/Perl/perl5/issues/19995">perl5/issue #19995</a> Symlink tests were previously skipped if <code>symlink()</code> is not available, and now also if creation of a symlink is not possible.</p>

<p>Fixes <a href="https://github.com/crenz/Module-Find/issues/9">issue #9</a>. Note that on Windows system, the patch to <code>File::Find</code> from <a href="https://github.com/Perl/perl5/pull/20008">perl5/PR #20008</a> will be required for proper operation.</p>

</dd>
</dl>

<h1 id="DEVELOPMENT-NOTES"><a id="DEVELOPMENT"></a>DEVELOPMENT NOTES</h1>

<p>The development repository for this module is hosted on GitHub: <a href="http://github.com/crenz/Module-Find/">http://github.com/crenz/Module-Find/</a>. Please report any bugs by opening an issue there.</p>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<p><a href="https://metacpan.org/pod/perl">perl</a>, <a href="./Module::Pluggable.html">Module::Pluggable</a>, <a href="https://metacpan.org/pod/Class::Factory::Util">Class::Factory::Util</a></p>

<h1 id="AUTHOR">AUTHOR</h1>

<p>Christian Renz, &lt;crenz@web42.com&gt;</p>

<h1 id="COPYRIGHT-AND-LICENSE"><a id="COPYRIGHT"></a>COPYRIGHT AND LICENSE</h1>

<p>Copyright 2004-2022 by Christian Renz &lt;crenz@web42.com&gt;. All rights reserved.</p>

<p>This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install Module::Find, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm Module::Find</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install Module::Find</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./Module::Find.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
